╔════════════════════════════════════════════════════════════════════════╗
║                                                                        ║
║      🔒 SECURITY HEADERS SCANNER - HERRAMIENTA EDUCATIVA 🔒            ║
║                                                                        ║
║      👨‍💻 Creado por: Maicken | Vida Tech                               ║
║      📚 Propósito: Educación en Ciberseguridad                         ║
║      ⚠️  Solo uso educativo y ético                                    ║
║                                                                        ║
╚════════════════════════════════════════════════════════════════════════╝


📋 DESCRIPCIÓN
═══════════════════════════════════════════════════════════════════════

Este script analiza las cabeceras de seguridad HTTP de sitios web para
identificar configuraciones de seguridad y posibles vulnerabilidades.

Cabeceras analizadas:
  • HSTS (HTTP Strict Transport Security)
  • CSP (Content Security Policy)
  • X-Frame-Options
  • X-Content-Type-Options
  • Referrer-Policy
  • Permissions-Policy
  • X-XSS-Protection


🖥️ REQUISITOS DEL SISTEMA
═══════════════════════════════════════════════════════════════════════

1. Sistema Operativo:
   ✓ Windows 10/11 (Recomendado)
   ✓ También compatible con Linux y macOS

2. Python:
   ✓ Python 3.7 o superior
   ✓ Descargar desde: https://www.python.org/downloads/
   ✓ IMPORTANTE: Al instalar, marcar "Add Python to PATH"

3. Conexión a Internet:
   ✓ Necesaria para instalar dependencias y analizar sitios web


📦 DEPENDENCIAS (Se instalan automáticamente)
═══════════════════════════════════════════════════════════════════════

  • requests >= 2.31.0 (Para peticiones HTTP)
  • beautifulsoup4 >= 4.12.0 (Para parsear HTML)


🚀 INSTALACIÓN Y USO
═══════════════════════════════════════════════════════════════════════

OPCIÓN 1: INSTALACIÓN AUTOMÁTICA (RECOMENDADO) ⚡
───────────────────────────────────────────────

1. Asegúrate de tener Python instalado
2. CLIC DERECHO en "instalar_y_ejecutar.bat"
3. Selecciona "Ejecutar como administrador" ⚠️ IMPORTANTE
4. El script instalará todo automáticamente y se ejecutará

¡Es así de fácil! 🎉

⚠️ ¿POR QUÉ COMO ADMINISTRADOR?
   - Permite instalar las dependencias de Python correctamente
   - Evita errores de permisos
   - Garantiza que todo funcione sin problemas


OPCIÓN 2: INSTALACIÓN MANUAL PASO A PASO
─────────────────────────────────────────

**PASO 1: Verificar Python instalado**

   a) Abre CMD o PowerShell
   b) Escribe: python --version
   c) Deberías ver algo como "Python 3.x.x"
   d) Si no está instalado, descárgalo de python.org

**PASO 2: Abrir terminal en la carpeta del script**

   MÉTODO A (Windows):
   - Abre la carpeta donde descargaste el script
   - Mantén presionada la tecla SHIFT
   - Haz CLIC DERECHO en un espacio vacío
   - Selecciona "Abrir ventana de PowerShell aquí" o "Abrir en Terminal"

   MÉTODO B (Windows):
   - Abre CMD (búscalo en el menú inicio)
   - Escribe: cd ruta\a\la\carpeta
   - Ejemplo: cd C:\Users\TuNombre\Downloads\Script-webscraping

**PASO 3: Instalar dependencias**

   Ejecuta el siguiente comando:
   
   pip install -r requirements.txt

   O instala las dependencias manualmente:
   
   pip install requests beautifulsoup4

   Espera a que termine la instalación (puede tardar 1-2 minutos)

**PASO 4: Ejecutar el script**

   Escribe:
   
   python phishing_scraper.py

   ¡Listo! El scanner se ejecutará


📖 CÓMO USAR EL SCANNER
═══════════════════════════════════════════════════════════════════════

1. Ejecuta el script (con el .bat o manualmente)

2. El programa te pedirá ingresar URLs de sitios web:
   
   • Ingresa URLs completas (ejemplo: https://www.google.com)
   • Presiona ENTER sin escribir nada para finalizar
   • Escribe "ejemplos" para usar sitios de demostración

3. El script analizará cada sitio y mostrará:
   
   ✓ Cabeceras de seguridad presentes
   ✗ Cabeceras ausentes (vulnerabilidades)
   📊 Puntuación de seguridad (0-100)
   💡 Recomendaciones de mejora


📝 EJEMPLOS DE SITIOS PARA ANALIZAR
═══════════════════════════════════════════════════════════════════════

Sitios seguros (para comparar):
  • https://www.google.com
  • https://github.com
  • https://www.facebook.com

Sitios sin HTTPS (para ver vulnerabilidades):
  • http://neverssl.com


⚠️ CONSIDERACIONES ÉTICAS Y LEGALES
═══════════════════════════════════════════════════════════════════════

✓ Solo analiza sitios públicos y con autorización
✓ Este script NO hackea ni compromete sitios
✓ Las cabeceras HTTP son información pública
✓ Úsalo solo con fines educativos
✓ No abuses haciendo peticiones masivas
✓ Respeta los términos de servicio de los sitios


🛠️ SOLUCIÓN DE PROBLEMAS
═══════════════════════════════════════════════════════════════════════

❌ Problema: "Python no está instalado" o "python no se reconoce"
✅ Solución: 
   1. Descarga e instala Python desde python.org
   2. Durante la instalación, MARCA la opción "Add Python to PATH" ⚠️ MUY IMPORTANTE
   3. Reinicia tu computadora
   4. Ejecuta el instalador nuevamente

❌ Problema: "Error de conexión al sitio"
✅ Solución: 
   - Verifica tu conexión a internet
   - Verifica que la URL esté correctamente escrita
   - Algunos sitios pueden bloquear el acceso automático

❌ Problema: "ModuleNotFoundError: No module named 'requests'"
✅ Solución: 
   1. Abre CMD como administrador
   2. Ejecuta: pip install requests beautifulsoup4
   3. Espera a que termine la instalación
   4. Ejecuta el script nuevamente

❌ Problema: "No such file or directory: phishing_scraper.py"
✅ Solución:
   1. Asegúrate de estar en la carpeta correcta
   2. Ejecuta el .bat como administrador con CLIC DERECHO
   3. O usa CMD y navega a la carpeta: cd ruta\a\la\carpeta

❌ Problema: "Error SSL" al analizar un sitio
✅ Solución: 
   - Esto es normal, el sitio tiene problemas de certificado
   - Es parte del análisis de seguridad
   - El script continuará con los demás sitios

❌ Problema: "Access denied" o "Permission denied"
✅ Solución:
   - Ejecuta el .bat como ADMINISTRADOR (clic derecho)
   - O ejecuta CMD/PowerShell como administrador

❌ Problema: Instalación lenta o se queda congelado
✅ Solución:
   - Es normal, la instalación puede tardar 2-3 minutos
   - Ten paciencia y NO cierres la ventana
   - Asegúrate de tener buena conexión a internet


📚 ARCHIVOS INCLUIDOS
═══════════════════════════════════════════════════════════════════════

  📄 phishing_scraper.py .......... Script principal
  📄 instalar_y_ejecutar.bat ...... Instalador automático (Windows)
  📄 requirements.txt ............. Dependencias de Python
  📄 LEEME.txt .................... Este archivo de instrucciones


💡 CONSEJOS Y TIPS
═══════════════════════════════════════════════════════════════════════

✅ SIEMPRE ejecuta el .bat como ADMINISTRADOR para evitar problemas
✅ Si tienes problemas, intenta la instalación manual paso a paso
✅ Verifica que Python esté en el PATH (variable de entorno)
✅ Mantén tu Python actualizado (versión 3.7 o superior)
✅ No cierres la ventana durante la instalación de dependencias
✅ Prueba primero con sitios conocidos (Google, Facebook, GitHub)
✅ Si un sitio falla, prueba con otro - es normal que algunos bloqueen
✅ Lee los resultados con calma y aprende de cada análisis

🔍 PARA VERIFICAR QUE TODO FUNCIONA:

   1. Abre CMD y ejecuta: python --version
      Deberías ver: Python 3.x.x

   2. Ejecuta: pip --version
      Deberías ver la versión de pip

   3. Ejecuta: pip list
      Deberías ver "requests" y "beautifulsoup4" en la lista


💡 APRENDE MÁS
═══════════════════════════════════════════════════════════════════════

Para aprender más sobre ciberseguridad y web scraping:

  📱 Sígueme en TikTok: Maicken | Vida Tech
  🎓 Contenido educativo de calidad
  🔒 Tutoriales de ciberseguridad
  💻 Tips de programación


🤝 SOPORTE Y CONTACTO
═══════════════════════════════════════════════════════════════════════

Si tienes problemas o preguntas:
  • Revisa este archivo LEEME.txt
  • Verifica que Python esté instalado correctamente
  • Asegúrate de tener conexión a internet


📄 LICENCIA
═══════════════════════════════════════════════════════════════════════

Este script es de uso educativo y gratuito.
Creado por: Maicken | Vida Tech
Propósito: Enseñanza de ciberseguridad ética


═══════════════════════════════════════════════════════════════════════
         ¡Gracias por usar Security Headers Scanner! 🔒
    Recuerda: Con gran poder viene gran responsabilidad 🦸‍♂️
═══════════════════════════════════════════════════════════════════════
